GetNtmsObjectSecurity 関数 (ntmsapi.h)

  • [アーティクル]

[リムーバブル 記憶域マネージャー は、Windows 7 および Windows Server 2008 R2 以降では使用できません。

GetNtmsObjectSecurity 関数は、指定された RSM オブジェクトのセキュリティ記述子を読み取ります。

構文

DWORD GetNtmsObjectSecurity(
  [in]  HANDLE               hSession,
  [in]  LPNTMS_GUID          lpObjectId,
  [in]  DWORD                dwType,
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR lpSecurityDescriptor,
  [in]  DWORD                nLength,
  [out] LPDWORD              lpnLengthNeeded
);

パラメーター

[in] hSession

OpenNtmsSession 関数によって返されるセッションを処理します。

[in] lpObjectId

RSM オブジェクトの一意識別子。

[in] dwType

オブジェクトの種類です。 オブジェクトの種類の一覧については、「 NtmsObjectsTypes」を参照してください。

[in] RequestedInformation

要求されたセキュリティ データを指定する SECURITY_INFORMATION 値。

[out] lpSecurityDescriptor

セキュリティ記述子を受け取る SECURITY_DESCRIPTOR 構造体へのポインター。

[in] nLength

記述子の長さ。

[out] lpnLengthNeeded

セキュリティ記述子に十分な大きさでない場合は、バッファーの必要な長さ (バイト単位)。

戻り値

この関数は、次のいずれかの値を返します。

値 意味
ERROR_ACCESS_DENIED
 オブジェクトへのアクセスが拒否READ_CONTROL。

Windows XP: アクセス権は必要ありません。
ERROR_DATABASE_FAILURE
 データベースにアクセスできないか、破損しています。
ERROR_INVALID_HANDLE
 セッション ハンドルがないか、無効です。
ERROR_INVALID_PARAMETER
 オブジェクト ID がありません。
ERROR_NO_SECURITY_ON_OBJECT
 このオブジェクトのセキュリティ情報はありません。
ERROR_OBJECT_NOT_FOUND
 オブジェクト ID が無効です。
ERROR_SUCCESS
 関数は成功しました。

注釈

RSM セキュリティでは、標準のセキュリティ記述子と情報メンバーが使用されます。 これにより、標準のセキュリティ ダイアログ ボックスを使用して RSM セキュリティを選択できます。 詳細については、「 SetPrivateObjectSecurity 関数」を参照してください。 RSM セキュリティの詳細については、「 RSM セキュリティ」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntmsapi.h
Library Ntmsapi.lib
[DLL] Ntmsapi.dll

こちらもご覧ください

EnumerateNtmsObject

オブジェクト管理機能

SetNtmsObjectSecurity