次の方法で共有

SERVICE_INFOW構造体 (nspapi.h)

  • [アーティクル]

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

構文

typedef struct _SERVICE_INFOW {
  LPGUID              lpServiceType;
  LPWSTR              lpServiceName;
  LPWSTR              lpComment;
  LPWSTR              lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPWSTR              lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOW, *PSERVICE_INFOW, *LPSERVICE_INFOW;

メンバーズ

lpServiceType

型: LPGUID

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

lpServiceName

型: LPTSTR

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

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

将来の使用のために予約されています。 0 にする必要があります。

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 [デスクトップ アプリのみ]
ヘッダー nspapi.h

関連項目

BLOB

GetService の

NS_SERVICE_INFO

SERVICE_ADDRESS

SERVICE_ADDRESSES

SERVICE_TYPE_INFO_ABS

SERVICE_TYPE_VALUE_ABS

SetService の