次の方法で共有

DSDISPLAYSPECOPTIONS 構造体 (dsclient.h)

  • [アーティクル]

DSDISPLAYSPECOPTIONS 構造体は、CFSTR_DS_DISPLAY_SPEC_OPTIONSクリップボード形式によって返され、使用される表示指定子に関するコンテキスト メニューまたはプロパティ ページ拡張機能にデータを提供するために使用されます。 Active Directory サーバーのデータにアクセスするには、拡張機能に必要な資格情報を指定することが重要です。

構文

typedef struct _DSDISPLAYSPECOPTIONS {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD offsetAttribPrefix;
  DWORD offsetUserName;
  DWORD offsetPassword;
  DWORD offsetServer;
  DWORD offsetServerConfigPath;
} DSDISPLAYSPECOPTIONS, *PDSDISPLAYSPECOPTIONS, *LPDSDISPLAYSPECOPTIONS;

メンバー

dwSize

バージョン管理用の構造体のサイズ。

dwFlags

オブジェクトに関するデータを示し、構造体の内容を定義するフラグのセット。 これは、0 または次の値の 1 つ以上の組み合わせにすることができます。

DSDSOF_HASUSERANDSERVERINFO (0x00000001)

offsetUserName、offsetPassword、offsetServer、offsetServerConfigPath の各メンバーが有効です。

DSDSOF_SIMPLEAUTHENTICATE (0x00000002)

ADsOpenObject を呼び出すときADS_SECURE_AUTHENTICATIONフラグを指定しないでください。

DSDSOF_DONTSIGNSEAL (0x00000004)

ディレクトリ サービス オブジェクトを開くときには、署名とシールを行わないでください。

DSDSOF_DSAVAILABLE (0x40000000)

クライアントがActive Directory Domain Servicesによって制御されるドメインに属していると仮定して、ユーザーが認証されているかどうか、ネットワークが存在するかログインしているかのチェックを避けるようにクライアントに強制します。

offsetAttribPrefix

DSDISPLAYSPECOPTIONS 構造体の先頭から NULL で終わる Unicode 文字列までのオフセットをバイト単位で格納します。この文字列には、作成された拡張が取得された表示指定子のプレフィックスが含まれます。 この文字列には、次のいずれかの値を指定できます。

"admin"

拡張機能は adminPropertyPages 属性から取得されました。

"shell"

拡張機能は shellPropertyPages 属性から取得されました。

次の例は、このメンバーの使用方法を示しています。

pwszAttribPrefix = (LPWSTR)((LPBYTE)pdos + 
    pdso->offsetAttribPrefix);

offsetUserName

DSDISPLAYSPECOPTIONS 構造体の先頭から NULL で終わる Unicode 文字列までのオフセットをバイト単位で格納します。この文字列には、バインドの認証に使用されるユーザーの名前が含まれます。 このメンバーは、 dwFlags に DSDSOF_HASUSERANDSERVERINFO フラグが含まれている場合にのみ有効です。 このメンバーにゼロが含まれている場合、ユーザー名は含まれません。

次の例は、このメンバーの使用方法を示しています。

pwszUserName = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetUserName);

offsetPassword

DSDISPLAYSPECOPTIONS 構造体の先頭から、バインドの認証に使用されるパスワードを含む NULL で終わる Unicode 文字列までのオフセットをバイト単位で格納します。 このメンバーは、 dwFlags に DSDSOF_HASUSERANDSERVERINFO フラグが含まれている場合にのみ有効です。 このメンバーにゼロが含まれている場合、パスワードは含まれません。

次の例は、このメンバーの使用方法を示しています。

pwszPassword = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetPassword);

offsetServer

DSDISPLAYSPECOPTIONS 構造体の先頭から、サーバーの名前を含む NULL で終わる Unicode 文字列までのオフセットをバイト単位で格納します。 このメンバーは、 dwFlags に DSDSOF_HASUSERANDSERVERINFO フラグが含まれている場合にのみ有効です。 このメンバーにゼロが含まれている場合、サーバー名は含まれません。

次の例は、このメンバーの使用方法を示しています。

pwszServer = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetServer);

offsetServerConfigPath

DSDISPLAYSPECOPTIONS 構造体の先頭から、サーバーの ADsPath を含む NULL で終わる Unicode 文字列までのオフセットをバイト単位で格納します。 このメンバーは、 dwFlags に DSDSOF_HASUSERANDSERVERINFO フラグが含まれている場合にのみ有効です。 このメンバーにゼロが含まれている場合、サーバー パスは含まれません。

次の例は、このメンバーの使用方法を示しています。

pwszServerConfigPath = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetServerConfigPath);

要件

   
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
Header dsclient.h

関連項目

ADsOpenObject

CFSTR_DS_DISPLAY_SPEC_OPTIONS

Active Directory Domain Servicesでの構造の表示