WSCEnumNameSpaceProviders32 関数 (ws2spi.h)

WSCEnumNameSpaceProviders32 関数は、使用可能な 32 ビット名前空間プロバイダーに関する情報を返します。

構文

INT WSAAPI WSCEnumNameSpaceProviders32(
  [in, out] LPDWORD              lpdwBufferLength,
  [out]     LPWSANAMESPACE_INFOW lpnspBuffer
);

パラメーター

[in, out] lpdwBufferLength

入力時に、 lpnspBuffer が指すバッファーに含まれるバイト数。 出力時 (関数が失敗し、エラーが WSAEFAULT の場合)、要求されたすべての情報を取得できるように lpnspBuffer バッファーに割り当てる最小バイト数。 WSCEnumNameSpaceProviders32 に渡されるバッファーは、すべての名前空間情報を保持するのに十分である必要があります。

[out] lpnspBuffer

WSANAMESPACE_INFOW構造体でいっぱいのバッファー。 返される構造体は、バッファーの先頭に連続して配置されます。 構造体内のポインターによって参照される可変サイズの情報は、固定サイズの構造体の末尾とバッファーの末尾の間にあるバッファー内の場所を指します。 入力された構造体の数は、 WSCEnumNameSpaceProviders32 の戻り値です。

戻り値

WSCEnumNameSpaceProviders32 関数は、lpnspBuffer にコピーされたWSANAMESPACE_INFOW構造体の数を返します。 それ以外の場合は、SOCKET_ERROR値が返され、 WSAGetLastError を呼び出すことによって特定のエラー番号を取得できます。

注釈

WSCEnumNameSpaceProviders32 は、厳密には 32 ビット バージョンの WSAEnumNameSpaceProviders です。 64 ビット コンピューターでは、32 ビット以外のすべての呼び出し (たとえば、"32" で終わっていないすべての関数) は、ネイティブの 64 ビット カタログで動作します。 64 ビット コンピューターで実行されるプロセスでは、特定の 32 ビット関数呼び出しを使用して、厳密に 32 ビット カタログを操作し、互換性を維持する必要があります。 特定の 32 ビット呼び出しの定義とセマンティクスは、ネイティブの呼び出しと同じです。

32 ビット SPI 関数は、"非表示" 名前空間プロバイダーの概念がないため、ネイティブ API 関数 (WSAEnumNameSpaceProviders) と同等です。

WSCEnumNameSpaceProviders32 関数は Unicode のみの関数であり、WSANAMESPACE_INFOEXW構造体を返します。

要件

こちらもご覧ください

WSAEnumNameSpaceProviders

WSANAMESPACE_INFOW

WSCInstallNameSpace32

WSCInstallNameSpaceEx32