次の方法で共有


SERVICE_INFOA 構造体 (nspapi.h)

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 つの例外があります。 pBlobDataSERVICE_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

こちらもご覧ください

BLOB

GetService

NS_SERVICE_INFO

SERVICE_ADDRESS

SERVICE_ADDRESSES

SERVICE_TYPE_INFO_ABS

SERVICE_TYPE_VALUE_ABS

SetService