NetDfsGetSecurity 関数 (lmdfs.h)
指定した DFS 名前空間のルート オブジェクトのセキュリティ記述子を取得します。
構文
NET_API_STATUS NET_API_FUNCTION NetDfsGetSecurity(
[in] LPWSTR DfsEntryPath,
[in] SECURITY_INFORMATION SecurityInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[out] LPDWORD lpcbSecurityDescriptor
);
パラメーター
[in] DfsEntryPath
DFS 名前空間ルートの汎用名前付け規則 (UNC) パスを指定する文字列へのポインター。
文字列は、2 つの形式のいずれかになります。 最初の形式は次のとおりです。
\\ Servername\DfsName
ここで 、ServerName はスタンドアロン DFS 名前空間をホストするルート ターゲット サーバーの名前で、 Dfsname は DFS 名前空間の名前です。
2 番目の形式は次のとおりです。
\\ Domainname\DomDfsName
ここで、DomainName はドメイン ベースの DFS 名前空間をホストするドメインの名前で、DomDfsName は DFS 名前空間の名前です。
[in] SecurityInformation
SECURITY_INFORMATION ルート オブジェクトから取得するセキュリティ情報の種類を示すビット フラグを含む構造体です。
[out] ppSecurityDescriptor
SecurityInformation パラメーターで要求されたセキュリティ項目を含むSECURITY_DESCRIPTOR構造体のリストへのポインター。
[out] lpcbSecurityDescriptor
ppSecurityDescriptor が指すバッファーのサイズ (バイト単位)。
戻り値
関数が成功した場合、戻り値は NERR_Success。
関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの一覧については、「 システム エラー コード」を参照してください。
注釈
ドメイン ベースの DFS 名前空間の場合、セキュリティ記述子は、DFS 名前空間をホストするドメインのプライマリ ドメイン コントローラー (PDC) から Active Directory の "CN=DomDfsName,CN=DFS-Configuration,CN=System,DC=domain" オブジェクトから取得されます。 DomDfsName はドメインベースの DFS 名前空間の名前で <、domain> は名前空間をホストする Active Directory ドメインの識別名です。
スタンドアロン ルートの場合、セキュリティ記述子は HKLM\Software\Microsoft\Dfs\スタンドアロン\<ルート名> レジストリ エントリで指定されたオブジェクトから取得されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008、Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | lmdfs.h (LmDfs.h、Lm.h を含む) |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |