RtlStringCbPrintfW 함수(ntstrsafe.h)

RtlStringCbPrintfW 및 RtlStringCbPrintfA 함수는 제공된 서식 정보를 기반으로 하는 서식을 사용하여 바이트 계산 텍스트 문자열을 만듭니다.

구문

NTSTRSAFEDDI RtlStringCbPrintfW(
  [out] NTSTRSAFE_PWSTR  pszDest,
  [in]  size_t           cbDest,
  [in]  NTSTRSAFE_PCWSTR pszFormat,
        ...              
);

매개 변수

[out] pszDest

형식이 지정된 null로 끝나는 문자열을 수신하는 호출자 제공 버퍼에 대한 포인터입니다. 함수는 pszFormat 에서 제공하는 서식 문자열과 함수의 인수 목록에서 이 문자열을 만듭니다.

[in] cbDest

대상 버퍼의 크기(바이트)입니다. 버퍼는 형식이 지정된 문자열과 종결 null 문자를 포함할 수 있을 만큼 커야 합니다.

유니코드 문자열의 경우 최대 바이트 수는 NTSTRSAFE_MAX_CCH * sizeof(WCHAR)입니다.

ANSI 문자열의 경우 최대 바이트 수는 * sizeof(char)NTSTRSAFE_MAX_CCH.

[in] pszFormat

printf 스타일 서식 지시문이 포함된 null로 끝나는 텍스트 문자열에 대한 포인터입니다.

...

pszFormat 문자열에 포함된 서식 지시문을 기반으로 함수에서 해석되는 인수 목록입니다.

반환 값

함수는 다음 표에 나열된 NTSTATUS 값 중 하나를 반환합니다. NTSTATUS 값을 테스트하는 방법에 대한 자세한 내용은 NTSTATUS 값 사용을 참조하세요.

설명

RtlStringCbPrintfW 및 RtlStringCbPrintfA 는 다음 함수 대신 사용해야 합니다.

• sprintf
• swprintf
• _snprintf
• _snwprintf

RtlStringCbPrintfW를 사용하여 유니코드 문자열을 처리하고 RtlStringCbPrintfA를 사용하여 ANSI 문자열을 처리합니다. 사용하는 양식은 다음 표와 같이 데이터에 따라 달라집니다.

pszDest 및 pszFormat이 겹치는 문자열을 가리키거나 인수 문자열이 겹치면 함수의 동작이 정의되지 않습니다.

pszFormat 또는 pszDest는 모두 NULL일 수 없습니다. NULL 문자열 포인터 값을 처리해야 하는 경우 RtlStringCbPrintfEx를 사용합니다.

안전한 문자열 함수에 대한 자세한 내용은 Safe String Functions 사용을 참조하세요.

예제

다음 예제에서는 네 개의 인수를 사용하여 RtlStringCbPrintfW 를 기본적으로 사용하는 방법을 보여 있습니다.

int const arraysize = 30;
WCHAR pszDest[arraysize]; 
size_t cbDest = arraysize * sizeof(WCHAR);

LPCWSTR pszFormat = L"%s %d + %d = %d.";
WCHAR* pszTxt = L"The answer is";

NTSTATUS status = RtlStringCbPrintfW(pszDest, cbDest, pszFormat, pszTxt, 1, 2, 3);

결과 문자열은 "대답은 1 + 2 = 3입니다." pszDest의 버퍼에 포함됩니다.

요구 사항

추가 정보

RtlStringCbPrintfEx

RtlStringCbVPrintf

RtlStringCchPrintf