다음을 통해 공유


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 포함)
라이브러리 Advapi32.lib
DLL Advapi32.dll

추가 정보

Access Control 개요

AllocateAndInitializeSid

기본 Access Control 함수

EqualSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

InitializeSid

IsValidSid

SID