WSAInstallServiceClassA 関数 (winsock2.h)

WSAInstallServiceClass 関数は、名前空間内にサービス クラス スキーマを登録します。 このスキーマには、クラス名、クラス識別子、およびサービスのすべてのインスタンスに共通する名前空間固有の情報 (SAP 識別子やオブジェクト識別子など) が含まれます。

構文

INT WSAAPI WSAInstallServiceClassA(
  [in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);

パラメーター

[in] lpServiceClassInfo

名前空間固有の型マッピング情報へのサービス クラス。 複数のマッピングを一度に処理できます。

関連するデータ構造の説明については、「 Service Class Data Structures 」セクションを参照してください。

戻り値

操作が成功した場合、戻り値は 0 です。 それ以外の場合は、SOCKET_ERROR値が返され、 WSAGetLastError を呼び出すことによって特定のエラー番号を取得できます。

エラー コード	意味
WSA_INVALID_PARAMETER	名前空間プロバイダーは、要求されたクラス情報を指定できません。
WSA_NOT_ENOUGH_MEMORY	操作を実行するためのメモリが不足していました。
WSAEACCES	呼び出し元関数には、サービスをインストールするための十分な特権がありません。
WSAEALREADY	サービス クラス情報は、このサービス クラス識別子に既に登録されています。 サービス クラス情報を変更するには、まず WSARemoveServiceClass を使用してから、更新されたクラス情報データを再インストールします。
WSAEINVAL	サービス クラス情報が正しくないか、正しく構造化されていませんでした。 lpServiceClassInfo パラメーターが NULL の場合、このエラーが返されます。
WSAEOPNOTSUPP	この操作はサポートされていません。 名前空間プロバイダーがこの関数を実装していない場合、このエラーが返されます。
WSANO_DATA	要求された名前は有効ですが、要求された種類のデータが見つかりませんでした。
WSANOTINITIALIZED	WS2_32.DLL が初期化されていません。 アプリケーションは、Windows ソケット関数を呼び出す前に、まず WSAStartup を呼び出す必要があります。

解説

Note

winsock2.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WSAInstallServiceClass を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winsock2.h
Library	Ws2_32.lib
[DLL]	Ws2_32.dll

関連項目

WSAGetLastError

WSAGetServiceClassInfo

WSASERVICECLASSINFO

Winsock 関数

Winsock リファレンス