PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME

リソースが自身の位置を特定するためにクラスターのネットワーク名を使用するように、リソースの環境データを調整します。対象のリソースは Network Name リソースに依存している必要があります。PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME 型は、この関数へのポインターを定義します。

操作が成功した場合、この関数は環境ブロックへのポインターを返します。

操作が失敗した場合、 この関数は NULL を返します。詳細については GetLastError を呼び出してください。

ResUtilGetEnvironmentWithNetName 関数は、現在の環境ブロックに環境変数を追加します。リソースを開始する際に、返された環境ブロックを CreateProcess に渡すと、次の効果が得られます。

• クライアントおよびクラスターは、Network Name リソースの名前を使用してリソースの場所を特定できます。
• リソースが GetComputerName、GetComputerNameEx、または gethostbyname を呼び出した場合、現在どのノードがそのリソースをホストしているかに関係なく、ネットワーク名が返されます。

環境ブロックを破棄するには ResUtilFreeEnvironment を使用します。

リソース DLL のエントリ ポイント関数から ResUtilGetEnvironmentWithNetName を呼び出さないでください。ResUtilGetEnvironmentWithNetName はワーカー スレッドから安全に呼び出せます。詳細については、リソース DLL で使用を避けるべき関数呼び出しを参照してください。