CopySid 関数 (securitybaseapi.h)
CopySid 関数は、セキュリティ識別子 (SID) をバッファーにコピーします。
構文
BOOL CopySid(
[in] DWORD nDestinationSidLength,
[out] PSID pDestinationSid,
[in] PSID pSourceSid
);
パラメーター
[in] nDestinationSidLength
SID のコピーを受信するバッファーの長さをバイト単位で指定します。
[out] pDestinationSid
ソース SID 構造体のコピーを受け取るバッファーへのポインター。
[in] pSourceSid
関数が pDestinationSid パラメーターによって指すバッファーにコピーする SID 構造体へのポインター。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
アプリケーションでは、CopySid 関数を使用して、アクセス 制御エントリ (ACE) で使用するアクセス トークン (たとえば、TOKEN_GROUPS構造) で SID のコピーを作成できます。
例
この関数を使用する例については、「 ログオン SID の取得」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | securitybaseapi.h (Windows.h を含む) |
| Library | Advapi32.lib |
| [DLL] | Advapi32.dll |