GetTypeByNameA 関数 (nspapi.h)
構文
INT GetTypeByNameA(
[in] LPSTR lpServiceName,
[in, out] LPGUID lpServiceType
);
パラメーター
[in] lpServiceName
サービスの名前を一意に表す、0 で終わる文字列へのポインター。 たとえば、"MY SNA SERVER" などです。
[in, out] lpServiceType
ネットワーク サービスの種類を指定するグローバル一意識別子 (GUID) を受け取る変数へのポインター。 Svcguid.h ヘッダー ファイルには、いくつかの GUID サービスの種類とマクロの定義が含まれています。
Svcguid.h ヘッダー ファイルは、Winsock2.h ヘッダー ファイルには自動的に含まれません。
戻り値
関数が成功した場合、戻り値は 0 です。
関数が失敗した場合、戻り値は SOCKET_ERROR( – 1) になります。 拡張エラー情報を取得するには、GetLastErrorを呼び出します。これは、次の拡張エラー値を返します。
価値 | 意味 |
---|---|
|
指定されたサービスの種類が不明です。 |
備考
手記
nspapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetTypeByName を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | nspapi.h |
ライブラリ | Mswsock.lib |
DLL | Mswsock.dll |