WSAGetServiceClassNameByClassIdW

WSAGetServiceClassNameByClassId 関数は、指定された型に関連付けられたサービスの名前を取得する。これは FTP や SNA といった一般的なサービス名であり、サービスの個別インスタンスの名前ではない。(Unicode)

WSAGetServiceClassNameByClassIdW lpServiceClassId, lpszServiceClassName, lpdwBufferLength

lpServiceClassId : [var] サービスクラスの GUID へのポインタ。
lpszServiceClassName : [wstr] サービス名へのポインタ。
lpdwBufferLength : [var] 入力時、lpszServiceClassName が返すバッファの長さ (文字数)。出力時、lpszServiceClassName にコピーされたサービス名の長さ (文字数)。

(プラグイン / モジュール : ws2_32.dll)

解説

WSAGetServiceClassNameByClassId 関数は、指定された型に関連付けられたサービスの名前を取得する。これは
FTP や SNA といった一般的なサービス名であり、サービスの個別インスタンスの名前ではない。(Unicode)

[戻り値]
WSAGetServiceClassNameByClassId 関数は、成功時はゼロを返す。そうでない場合は SOCKET_ERROR
を返し、WSAGetLastError を呼び出すことで特定のエラー番号を取得できる。
（以下省略）

[備考]
> [!NOTE] > winsock2.h ヘッダは、UNICODE プリプロセッサ定数の定義に基づいて本関数の ANSI 版と
Unicode 版を自動的に選択するエイリアスとして WSAGetServiceClassNameByClassId
を定義している。エンコーディング中立なエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーを招く不整合が発生しうる。詳しくは
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報