GetTypeByNameW 関数 (nspapi.h)
GetTypeByName 関数は、名前で指定されたネットワーク サービスのサービスの種類 GUID を取得します。
メモGetTypeByName 関数は、Windows ソケット 1.1 仕様に対する Microsoft 固有の拡張機能です。 この関数は、現在使用されていません。 Windows Sockets 1.1 開発者の便宜のために、このリファレンス 資料が含まれています。 「プロトコルに依存しない名前解決」で詳しく説明されている関数は、Windows ソケット 2 で同等の機能を提供します。
構文
INT GetTypeByNameW(
[in] LPWSTR 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 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | nspapi.h |
| Library | Mswsock.lib |
| [DLL] | Mswsock.dll |