ホーム › Networking.ActiveDirectory › ADS_DEREFENUM

ADS_DEREFENUM

列挙型

基底型i4

メンバー 4

名前	10進	16進	説明
ADS_DEREF_NEVER	0	0x0	検索時も、検索の基点となるオブジェクトを特定する際も、エイリアスを逆参照しません。
ADS_DEREF_SEARCHING	1	0x1	基点オブジェクトの下位を検索する際にはエイリアスを逆参照しますが、基点そのものを特定する際には逆参照しません。
ADS_DEREF_FINDING	2	0x2	検索の基点となるオブジェクトを特定する際にはエイリアスを逆参照しますが、その下位を検索する際には逆参照しません。
ADS_DEREF_ALWAYS	3	0x3	下位を検索する際と、検索の基点となるオブジェクトを特定する際の両方で、エイリアスを逆参照します。

公式ドキュメント

ADS_DEREFENUM 列挙型は、エイリアスを解決 (逆参照) する方法を指定します。

解説(Remarks)

IDirectorySearch インターフェイスは、これらの定数を使用してエイリアスの逆参照動作を設定します。オプションを指定しない場合、サーバーの既定値は ADS_DEREF_NEVER です。

メモ VBScript はタイプライブラリからデータを読み取ることができないため、VBScript アプリケーションでは上記で定義された記号定数は認識されません。代わりに数値定数を使用して、VBScript アプリケーションで適切なフラグを設定してください。記号定数を使用する場合は、優れたプログラミング作法として、ここで示すように定数を明示的に宣言してください。

例

次のコード例は、エイリアスの逆参照に関する検索設定を行う方法を示しています。m_pSearch は、IDirectorySearch インターフェイスを実装するオブジェクトへのポインターを指します。

ADS_SEARCHPREF_INFO prefInfo[1];
HRESULT hr;
 
prefInfo[0].dwSearchPref   = ADS_SEARCHPREF_DEREF_ALIASES;
prefInfo[0].vValue.dwType  = ADSTYPE_INTEGER;
prefInfo[0].vValue.Integer = ADS_DEREF_ALWAYS;
hr = m_pSearch->SetSearchPreference(prefInfo, 1);

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum ADS_DEREFENUM : int {
    ADS_DEREF_NEVER = 0,
    ADS_DEREF_SEARCHING = 1,
    ADS_DEREF_FINDING = 2,
    ADS_DEREF_ALWAYS = 3
} ADS_DEREFENUM;

public enum ADS_DEREFENUM : int
{
    ADS_DEREF_NEVER = 0,
    ADS_DEREF_SEARCHING = 1,
    ADS_DEREF_FINDING = 2,
    ADS_DEREF_ALWAYS = 3,
}

Public Enum ADS_DEREFENUM As Integer
    ADS_DEREF_NEVER = 0
    ADS_DEREF_SEARCHING = 1
    ADS_DEREF_FINDING = 2
    ADS_DEREF_ALWAYS = 3
End Enum

import enum

class ADS_DEREFENUM(enum.IntEnum):
    ADS_DEREF_NEVER = 0
    ADS_DEREF_SEARCHING = 1
    ADS_DEREF_FINDING = 2
    ADS_DEREF_ALWAYS = 3

// ADS_DEREFENUM
pub const ADS_DEREF_NEVER: i32 = 0;
pub const ADS_DEREF_SEARCHING: i32 = 1;
pub const ADS_DEREF_FINDING: i32 = 2;
pub const ADS_DEREF_ALWAYS: i32 = 3;

// ADS_DEREFENUM
const (
	ADS_DEREF_NEVER int32 = 0
	ADS_DEREF_SEARCHING int32 = 1
	ADS_DEREF_FINDING int32 = 2
	ADS_DEREF_ALWAYS int32 = 3
)

const
  ADS_DEREF_NEVER = 0;
  ADS_DEREF_SEARCHING = 1;
  ADS_DEREF_FINDING = 2;
  ADS_DEREF_ALWAYS = 3;

// ADS_DEREFENUM
pub const ADS_DEREF_NEVER: i32 = 0;
pub const ADS_DEREF_SEARCHING: i32 = 1;
pub const ADS_DEREF_FINDING: i32 = 2;
pub const ADS_DEREF_ALWAYS: i32 = 3;

const
  ADS_DEREF_NEVER* = 0
  ADS_DEREF_SEARCHING* = 1
  ADS_DEREF_FINDING* = 2
  ADS_DEREF_ALWAYS* = 3

enum ADS_DEREFENUM : int {
    ADS_DEREF_NEVER = 0,
    ADS_DEREF_SEARCHING = 1,
    ADS_DEREF_FINDING = 2,
    ADS_DEREF_ALWAYS = 3,
}

#define global ADS_DEREF_NEVER     0x0
#define global ADS_DEREF_SEARCHING 0x1
#define global ADS_DEREF_FINDING   0x2
#define global ADS_DEREF_ALWAYS    0x3