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