DsAddressToSiteNamesExA 関数 (dsgetdc.h)
DsAddressToSiteNamesEx 関数は、指定されたアドレスに対応するサイト名とサブネット名を取得します。
構文
DSGETDCAPI DWORD DsAddressToSiteNamesExA(
[in, optional] LPCSTR ComputerName,
[in] DWORD EntryCount,
[in] PSOCKET_ADDRESS SocketAddresses,
[out] LPSTR **SiteNames,
[out] LPSTR **SubnetNames
);
パラメーター
[in, optional] ComputerName
この関数を処理するリモート サーバーの名前を指定する null で終わる文字列へのポインター。 このパラメーターは、ドメイン コントローラーの名前である必要があります。 ドメイン コントローラー以外の場合は、 DsGetDcName を呼び出してドメイン コントローラーを検索することで、この関数を呼び出すことができます。
[in] EntryCount
SocketAddresses 配列内の要素の数を格納します。
[in] SocketAddresses
変換するアドレスを含む SOCKET_ADDRESS 構造体の配列を格納します。 この配列内の各アドレスは 、AF_INET型である必要があります。 EntryCount には、この配列内の要素の数が含まれます。
[out] SiteNames
アドレスのサイト名を含む null で終わる文字列ポインターの配列を受け取ります。 この配列内の各要素は、 SocketAddresses 配列内の同じ要素に対応します。 対応するアドレスが既知のサイトにマップされない場合、またはアドレスエントリが適切な形式でない場合、要素は NULL です。 呼び出し元は、 NetApiBufferFree を呼び出して不要になった場合に、この配列を解放する必要があります。
[out] SubnetNames
サイト名マッピングへのアドレスの実行に使用されるサブネット名を含む、null で終わる文字列ポインターの配列を受け取ります。 この配列内の各要素は、 SocketAddresses 配列内の同じ要素に対応します。 サイト名マッピングに対応するアドレスが特定されなかった場合、または対応するアドレスをサイト マッピングに実行するためにサブネットが使用されなかった場合、要素は NULL です。 後者は、サブネット オブジェクトがマップされていない企業内のサイトが 1 つだけ存在する場合に当たります。 呼び出し元は、 NetApiBufferFree を呼び出して不要になった場合に、この配列を解放する必要があります。
戻り値
成功した場合 はNO_ERROR 、それ以外の場合は Win32 または RPC エラーを返します。 考えられるエラー コードを次に示します。
注釈
注意
dsgetdc.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DsAddressToSiteNamesEx を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | dsgetdc.h |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |