SERVICE_INFOA 構造体 (nspapi.h)

[アーティクル]
03/15/2023

SERVICE_INFO構造体には、ネットワークサービスまたはネットワークサービスの種類に関する情報が含まれています。

構文

typedef struct _SERVICE_INFOA {
  LPGUID              lpServiceType;
  LPSTR               lpServiceName;
  LPSTR               lpComment;
  LPSTR               lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPSTR               lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOA, *PSERVICE_INFOA, *LPSERVICE_INFOA;

メンバー

lpServiceType

種類: LPGUID

ネットワークサービスの種類である GUID へのポインター。

lpServiceName

種類: LPTSTR

ネットワークサービスの名前である NULL で終わる文字列へのポインター。

dwNameSpace パラメーターを NS_DEFAULT に設定して SetService 関数を呼び出す場合、ネットワークサービス名は共通名である必要があります。一般的な名前は、ネットワークサービスの一般的な名前です。ネットワークサービスの一般的な名前の例として、"My SQL Server" があります。

dwNameSpace パラメーターを特定のサービス名に設定して SetService 関数を呼び出す場合、ネットワークサービス名には共通名または識別名を指定できます。識別名は、ディレクトリサービスを使用してサービスを一意の場所と区別します。ネットワークサービスの識別名の例として、"MS\SYS\NT\DEV\My SQL Server" があります。

lpComment

種類: LPTSTR

ネットワークサービスのコメントまたは説明である NULL で終わる文字列へのポインター。たとえば、"開発のアップグレードに使用されます" などです。

lpLocale

種類: LPTSTR

ロケール情報を含む NULL で終わる文字列へのポインター。

dwDisplayHint

型: DWORD

ネットワーク参照ユーザーインターフェイスでネットワークサービスを表示する方法に関するヒント。次のいずれかの値を指定できます。

値	意味
RESOURCEDISPLAYTYPE_DOMAIN	ネットワークサービスをドメインとして表示します。
RESOURCEDISPLAYTYPE_FILE	ネットワークサービスをファイルとして表示します。
RESOURCEDISPLAYTYPE_GENERIC	オブジェクトの表示に使用されるメソッドは重要ではありません。
RESOURCEDISPLAYTYPE_GROUP	ネットワークサービスをグループとして表示します。
RESOURCEDISPLAYTYPE_SERVER	ネットワークサービスをサーバーとして表示します。
RESOURCEDISPLAYTYPE_SHARE	ネットワークサービスを SharePoint として表示します。
RESOURCEDISPLAYTYPE_TREE	ネットワークサービスをツリーとして表示します。

dwVersion

型: DWORD

ネットワークサービスのバージョン。この値の上位ワードは、メジャーバージョン番号を指定します。この値の下位ワードはマイナーバージョン番号を指定します。

dwTime

型: DWORD

将来利用するために予約されています。ゼロを指定してください。

lpMachineName

種類: LPTSTR

ネットワークサービスが実行されているコンピューターの名前である NULL で終わる文字列へのポインター。

lpServiceAddress

種類: LPSERVICE_ADDRESSES

SERVICE_ADDRESS構造体の配列を含むSERVICE_ADDRESSES構造体へのポインター。各 SERVICE_ADDRESS 構造体には、ネットワークサービスアドレスに関する情報が含まれています。

ネットワークサービスは、getsockname 関数を呼び出して、システムのローカルアドレスを決定できます。

ServiceSpecificInfo

種類: BLOB

サービス定義情報を指定する BLOB 構造体。

メモ一般に、 BLOB 構造体の pBlobData メンバーが指すデータにはポインターを含めてはなりません。これは、ネットワークサービスのみがデータの形式を認識するためです。このような知識なしでデータをコピーすると、ポインターが無効になります。 pBlobData が指すデータに可変サイズの要素が含まれている場合は、pBlobData からのオフセットを使用して、それらの要素の位置を示すことができます。この一般的な規則には 1 つの例外があります。 pBlobData が SERVICE_TYPE_INFO_ABS 構造体を指す場合です。これは、SERVICE_TYPE_INFO_ABS構造体と、その構造に含まれるすべてのSERVICE_TYPE_VALUE_ABS 構造体の両方が事前に定義されているため、その形式がオペレーティングシステムに知られているためです。

注釈

注意

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

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	nspapi.h