WSAInstallServiceClassA 関数 (winsock2.h)
WSAInstallServiceClass 関数は、名前空間内にサービス クラス スキーマを登録します。 このスキーマには、クラス名、クラス識別子、およびサービスのすべてのインスタンスに共通する名前空間固有の情報 (SAP 識別子やオブジェクト識別子など) が含まれます。
構文
INT WSAAPI WSAInstallServiceClassA(
[in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);
パラメーター
[in] lpServiceClassInfo
名前空間固有の型マッピング情報へのサービス クラス。 複数のマッピングを一度に処理できます。
関連するデータ構造の説明については、「 Service Class Data Structures 」セクションを参照してください。
戻り値
操作が成功した場合、戻り値は 0 です。 それ以外の場合は、SOCKET_ERROR値が返され、 WSAGetLastError を呼び出すことによって特定のエラー番号を取得できます。
| エラー コード | 意味 |
|---|---|
| 名前空間プロバイダーは、要求されたクラス情報を指定できません。 | |
| 操作を実行するためのメモリが不足していました。 | |
| 呼び出し元関数には、サービスをインストールするための十分な特権がありません。 | |
| サービス クラス情報は、このサービス クラス識別子に既に登録されています。 サービス クラス情報を変更するには、まず WSARemoveServiceClass を使用してから、更新されたクラス情報データを再インストールします。 | |
| サービス クラス情報が正しくないか、正しく構造化されていませんでした。 lpServiceClassInfo パラメーターが NULL の場合、このエラーが返されます。 | |
| この操作はサポートされていません。 名前空間プロバイダーがこの関数を実装していない場合、このエラーが返されます。 | |
| 要求された名前は有効ですが、要求された種類のデータが見つかりませんでした。 | |
| 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 |