次の方法で共有


GetTypeByNameA 関数 (nspapi.h)

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

GetTypeByName 関数は、Windows ソケット 1.1 仕様に対する Microsoft 固有の拡張機能です。 この関数は廃止されています。 Windows Sockets 1.1 開発者の利便性のために、このリファレンス 資料が含まれています。 Protocol-Independent 名前解決 で詳しく説明されている関数は、Windows ソケット 2 で同等の機能を提供します。
 

構文

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を呼び出します。これは、次の拡張エラー値を返します。

価値 意味
ERROR_SERVICE_DOES_NOT_EXIST
指定されたサービスの種類が不明です。

備考

手記

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

必要条件

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

関連項目

GetNameByType

Winsock Functions

Winsock リファレンス