StringCchPrintf_lA 함수(strsafe.h)

서식이 지정된 데이터를 지정된 문자열에 씁니다. 대상 버퍼의 크기는 이 버퍼의 끝을 지나서 작성되지 않도록 함수에 제공됩니다.

StringCchPrintf_lStringCchPrintf 유사하지만 로캘 정보에 대한 매개 변수를 포함합니다.

통사론

STRSAFEAPI StringCchPrintf_lA(
  [out] STRSAFE_LPSTR                                  pszDest,
  [in]  size_t                                         cchDest,
  [in]  _Printf_format_string_params_(2)STRSAFE_LPCSTR pszFormat,
  [in]  _locale_t                                      locale,
        ...                                            
);

매개 변수

[out] pszDest

pszFormat 및 해당 인수에서 만든 형식이 지정된 null로 끝나는 문자열을 수신하는 대상 버퍼입니다.

[in] cchDest

대상 버퍼의 크기(문자)입니다. 이 값은 최종 형식이 지정된 문자열을 수용할 수 있을 정도로 충분히 커야 하며 종료 null 문자를 고려하려면 1을 더해야 합니다. 허용되는 최대 문자 수는 STRSAFE_MAX_CCH.

[in] pszFormat

형식 문자열입니다. 이 문자열은 null로 종료되어야 합니다. 자세한 내용은 형식 사양 구문참조하세요.

[in] locale

로캘 개체입니다. 자세한 내용은 _create_locale참조하세요.

...

pszFormat 문자열에 삽입할 인수입니다.

반환 값

이 함수는 다음 값 중 하나를 반환할 수 있습니다. succeeded 사용하고 failed 매크로를 이 함수의 반환 값을 테스트하는 것이 좋습니다.

반환 코드	묘사
S_OK	결과를 잘림 없이 pszDest 복사할 충분한 공간이 있었고 버퍼는 null로 종료됩니다.
STRSAFE_E_INVALID_PARAMETER	cchDest 값은 0이거나 STRSAFE_MAX_CCH보다 큽다.
STRSAFE_E_INSUFFICIENT_BUFFER	버퍼 공간이 부족하여 복사 작업이 실패했습니다. 대상 버퍼에는 의도한 결과의 잘린 null 종료 버전이 포함됩니다. 잘림이 허용되는 상황에서는 반드시 실패 조건으로 간주되지 않을 수 있습니다.

발언

pszDest, pszFormat또는 인수 문자열이 가리키는 문자열이 겹치면 동작이 정의되지 않습니다.

pszFormat 또는 pszDest NULL안 됩니다. null 문자열 포인터 값을 처리해야 하는 경우 StringCchPrintf_lEx 참조하세요.

이 함수를 사용하려면 StrSafe.h를 포함하기 전에 헤더 파일에서 다음 매크로를 정의해야 합니다.

#define STRSAFE_LOCALE_FUNCTIONS

메모

strsafe.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 StringCchPrintf_l 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	strsafe.h