Str_GetPtr 함수

[이 함수는 Windows XP 서비스 팩 2(SP2) 및 Windows Server 2003을 통해 사용할 수 있습니다. 이후 버전의 Windows에서는 변경되거나 사용하지 못할 수 있습니다.]

한 버퍼에서 다른 버퍼로 문자열을 복사합니다.

구문

int WINAPI Str_GetPtr(
  _In_    LPCTSTR pszSource,
  _Inout_ LPCSTR  pszDest,
  _In_    int     cchDest
);

매개 변수

pszSource [in]

형식: LPCTSTR

원본 문자열에 대한 포인터입니다.

pszDest [in, out]

형식: LCSTTR

대상 버퍼에 대한 포인터입니다. 이 값은 NULL일 수 있습니다.

cchDest [in]

형식: int

pszDest의 크기(문자).

반환 값

형식: int

pszDest가 NULL이거나 cchDest가 0이면 pszSource가 가리키는 문자열의 null 종료 복사본을 포함하는 데 필요한 버퍼 크기를 문자로 반환합니다.

pszDest가 NULL이 아닌 경우 종료 Null 문자를 포함하여 성공적으로 복사된 문자 수를 반환합니다.

pszSource가 가리키는 전체 문자열을 pszDest가 보유할 수 없는 경우 (cchDest-1)개의 문자가 복사되고 문자열은 null로 종료되며 cchDest가 반환됩니다.

설명

Str_GetPtr은 ANSI(Str_GetPtrA) 및 유니코드(Str_GetPtrW) 버전으로 사용할 수 있습니다. 이러한 함수는 이름으로 내보내거나 공용 헤더 파일에서 선언되지 않습니다. 이를 사용하려면 GetProcAddress를 사용하고 ComCtl32.dll의 서수 233(Str_GetPtrA) 또는 235(Str_GetPtrW)를 요청하여 함수 포인터를 가져와야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
DLL	ComCtl32.dll
유니코드 및 ANSI 이름	Str_GetPtrW(유니코드) 및 Str_GetPtrA(ANSI)