GetServiceA 関数 (nspapi.h)
GetService 関数は、一連の既定の名前空間または指定された名前空間のコンテキストで、ネットワーク サービスに関する情報を取得します。 ネットワーク サービスは、その種類と名前で指定されます。 サービスに関する情報は、一連の NS_SERVICE_INFO データ構造として取得されます。
構文
INT GetServiceA(
[in] DWORD dwNameSpace,
[in] LPGUID lpGuid,
[in] LPSTR lpServiceName,
[in] DWORD dwProperties,
[out] LPVOID lpBuffer,
[in, out] LPDWORD lpdwBufferSize,
[in, optional] LPSERVICE_ASYNC_INFO lpServiceAsyncInfo
);
パラメーター
[in] dwNameSpace
オペレーティング システムが指定したネットワーク サービスに関する情報を照会する名前空間または既定の名前空間のセット。
名前空間を指定するには、次のいずれかの定数を使用します。
GetService を
[in] lpGuid
ネットワーク サービスの種類を指定するグローバル一意識別子 (GUID) へのポインター。 Svcguid.h ヘッダー ファイルには、DNS および SAP 名前空間内の多くの既知のサービスからの GUID サービスの種類が含まれています。
Svcguid.h ヘッダー ファイルは、Winsock2.h ヘッダー ファイルには自動的に含まれません。
[in] lpServiceName
サービス名を一意に表す、0 で終わる文字列へのポインター。 たとえば、"MY SNA SERVER" などです。
[in] dwProperties
関数が取得するサービス情報を指定するビット フラグのセット。 PROP_ALL以外のこれらのビット フラグ定数はそれぞれ、SERVICE_INFO データ構造の特定のメンバーに対応します。 フラグが設定されている場合、この関数は、 *lpBufferに格納されているデータ構造の対応するメンバーに情報を入れます。 次のビット フラグが定義されています。
[out] lpBuffer
NS_SERVICE_INFO 構造体と関連するサービス情報の配列を受け取るバッファーへのポインター。 各 NS_SERVICE_INFO 構造体には、特定の名前空間のコンテキストでサービス情報が含まれています。 dwNameSpace
各 NS_SERVICE_INFO 構造体には、SERVICE_INFO 構造体が含まれています。 これらの SERVICE_INFO 構造体のメンバーには、dwProperties パラメーターに設定されているビット フラグに基づく有効なデータが含まれます。 dwPropertiesでメンバーの対応するビット フラグ
この関数は、バッファーの先頭から開始して、NS_SERVICE_INFO 構造体を連続する配列に格納します。 格納されている SERVICE_INFO 構造体内のポインターは、NS_SERVICE_INFO 構造体の末尾とバッファーの末尾の間のバッファーに格納されている情報を指します。
[in, out] lpdwBufferSize
入力時に lpBufferが指すバッファーのサイズをバイト単位で格納する変数へのポインター
[in, optional] lpServiceAsyncInfo
将来の使用のために予約されています。 NULLを
戻り値
関数が成功した場合、戻り値は *lpBufferに格納されている NS_SERVICE_INFO 構造体の数です。 ゼロは、構造体が格納されなかったことを示します。
関数が失敗した場合、戻り値は SOCKET_ERROR ( – 1) になります。 拡張エラー情報を取得するには、GetLastErrorを呼び出します。これは、次のいずれかの拡張エラー値を返します。
| エラー コード | 意味 |
|---|---|
|
lpBuffer |
|
指定したサービスが見つからなかったか、指定した名前空間が使用されていません。 この場合、関数の戻り値は 0 です。 |
備考
手記
nspapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetService を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | nspapi.h |
| ライブラリ | Mswsock.lib |
| DLL | Mswsock.dll |
関連項目
SetService の