WSASetServiceA 関数 (winsock2.h)

WSASetService 関数は、1 つ以上の名前空間内のサービス インスタンスをレジストリに登録または削除します。

構文

INT WSAAPI WSASetServiceA(
  [in] LPWSAQUERYSETA   lpqsRegInfo,
  [in] WSAESETSERVICEOP essoperation,
  [in] DWORD            dwControlFlags
);

パラメーター

[in] lpqsRegInfo

登録または登録解除のためのサービス情報へのポインター。

[in] essoperation

要求された操作を決定する 値。 このパラメーターには、 Winsock2.h ヘッダー ファイルで定義されている WSAESETSERVICEOP 列挙型の値のいずれかを指定できます。

[in] dwControlFlags

WSASetService 関数の実行操作をさらに制御するサービス インストール フラグの値。 このパラメーターに指定できる値は、 Winsock2.h ヘッダー ファイルで定義されています。

戻り値

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

注釈

WSASetService 関数を使用して、特定の名前空間プロバイダー、特定の名前空間に関連付けられているすべてのプロバイダー、またはすべての名前空間のすべてのプロバイダーに影響を与えることができます。

次の表に示すように、 essOperation と dwControlFlags で使用できる値を組み合わせて 、WSASetService 関数の操作を制御します。

Active Directory サービスなどのディレクトリへのサービスの発行は、アクセス制御リスト (ACL) に基づいて制限されます。 詳細については、「 サービスパブリケーションのセキュリティの問題」を参照してください。

dwControlFlags パラメーターが SERVICE_MULTIPLE に設定されている場合、アプリケーションはそのアドレスを個別に管理できます。 これは、アプリケーションがプロトコルを個別に管理する場合や、サービスが複数のコンピューターに存在する場合に便利です。 たとえば、サービスで複数のプロトコルが使用されている場合、1 つのリッスン しているソケットが中止されますが、他のソケットは操作可能なままになります。 この場合、サービスは、他のアドレスに影響を与えることなく、中止されたアドレスをレジストリから削除できます。

dwControlFlags パラメーターが SERVICE_MULTIPLE に設定されている場合、アプリケーションは古いアドレスを オブジェクトに残してはなりません。 これは、DEREGISTER 要求を発行せずにアプリケーションが中止された場合に発生する可能性があります。 サービスが登録するときは、そのアドレスを格納する必要があります。 次の呼び出しで、サービスは新しいアドレスを登録する前に、これらの古い古いアドレスをレジストリから明示的に削除する必要があります。

サービスのプロパティ

次に示すように、 dwNameSpace メンバーと lpNSProviderId メンバーの組み合わせによって、名前空間プロバイダーがこの関数の影響を受けるかどうかを判断します。

Windows Phone 8:WSASetServiceW 関数は、Windows Phone 8 以降のWindows Phone ストア アプリでサポートされています。

Windows 8.1およびWindows Server 2012 R2: WSASetServiceW 関数は、Windows 8.1、Windows Server 2012 R2 以降の Windows ストア アプリでサポートされています。

要件

こちらもご覧ください

Bluetooth と WSASetService

WSAGetLastError

WSAStartup

Winsock 関数

Winsock リファレンス