ResUtilGetEnvironmentWithNetName-Funktion (resapi.h)

  • Artikel

Passt Umgebungsdaten für eine Ressource an, sodass die Ressource einen Clusternetzwerknamen verwendet, um ihren Standort zu identifizieren. Die Ressource muss von einer Netzwerknamenressource abhängig sein. Der PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME Typ definiert einen Zeiger auf diese Funktion.

Syntax

LPVOID ResUtilGetEnvironmentWithNetName(
  [in] HRESOURCE hResource
);

Parameter

[in] hResource

Handle für eine Ressource, die von einer Netzwerknamenressource abhängt.

Rückgabewert

Wenn die Vorgänge erfolgreich sind, gibt die Funktion einen Zeiger auf den Umgebungsblock zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion NULL zurück. Weitere Informationen finden Sie unter GetLastError.

Hinweise

Die ResUtilGetEnvironmentWithNetName-Funktion fügt Umgebungsvariablen an den aktuellen Umgebungsblock an. Übergeben Sie den zurückgegebenen Umgebungsblock an CreateProcess , wenn Sie die Ressource starten, um die folgenden Auswirkungen zu erzielen:

  • Clients und der Cluster können die Ressource mithilfe des Namens der Netzwerknamenressource suchen.
  • Wenn die Ressource GetComputerName, GetComputerNameEx oder gethostbyname aufruft, wird der Netzwerkname unabhängig davon zurückgegeben, auf welchem Knoten die Ressource derzeit gehostet wird.
Wenn die von hResource identifizierte Ressource nicht von einer Netzwerknamenressource abhängig ist, gibt ResUtilGetEnvironmentWithNetNameNULL zurück.

Verwenden Sie ResUtilFreeEnvironment , um den Umgebungsblock zu zerstören.

Rufen Sie ResUtilGetEnvironmentWithNetName nicht von einer Ressourcen-DLL-Einstiegspunktfunktion auf. ResUtilGetEnvironmentWithNetName kann sicher aus einem Workerthread aufgerufen werden. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform Windows
Kopfzeile resapi.h
Bibliothek ResUtils.lib
DLL ResUtils.dll

Weitere Informationen

ResUtilSetResourceServiceEnvironment