GetNameByTypeA 関数 (nspapi.h)

GetNameByType 関数は、指定されたサービスの種類のネットワーク サービスの名前を取得します。

注GetNameByType 関数は、Windows Sockets 1.1 仕様に対する Microsoft 固有の拡張機能です。 この関数は廃止されています。 Windows Sockets 1.1 開発者の便宜上、参考資料は次のとおりです。

 

メモ Windows ソケット 2 で同等の機能 Protocol-Independent 名前解決 で詳しく説明されている機能です。

 

構文

INT GetNameByTypeA(
  [in]  LPGUID lpServiceType,
  [out] LPSTR  lpServiceName,
  [in]  DWORD  dwNameLength
);

パラメーター

[in] lpServiceType

ネットワーク サービスの種類を指定するグローバル一意識別子 (GUID) へのポインター。 Svcguid.h ヘッダー ファイルには、いくつかの GUID サービスの種類の定義と、それらを操作するためのマクロが含まれています。

Svcguid.h ヘッダー ファイルは、Winsock2.h ヘッダー ファイルには自動的に含まれません。

[out] lpServiceName

ネットワーク サービスの名前を一意に表す 0 で終わる文字列を受け取るバッファーへのポインター。

[in] dwNameLength

入力時に、lpServiceNameが指すバッファーのサイズをバイト単位で指定する変数 ポインター。 出力時に、変数にはサービス名文字列の実際のサイズがバイト単位で格納されます。

戻り値

関数が成功した場合、戻り値はSOCKET_ERRORされません (–1)。

関数が失敗した場合、戻り値はSOCKET_ERROR (–1) になります。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

手記

nspapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetNameByType を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	nspapi.h
ライブラリ	Mswsock.lib
DLL	Mswsock.dll

関連項目

GetTypeByName を する

Winsock Functions

Winsock リファレンス