CHString::GetBuffer 메서드(chstring.h)

[CHString 클래스는 현재 최종 상태로 간주되는 WMI 공급자 프레임워크의 일부로, 이 라이브러리에 영향을 미치는 보안과 관련되지 않은 문제에 대해서는 더 이상 개발, 개선 또는 업데이트가 이루어지지 않습니다. MI API는 모든 새 개발에 사용해야 합니다.]

GetBuffer 메서드는 CHString 개체의 내부 문자 버퍼에 대한 포인터를 반환합니다.

구문

LPWSTR  throw(CHeap_Exception) GetBuffer(
  int nMinBufLength
);

매개 변수

nMinBufLength

문자 버퍼의 최소 크기(문자)입니다. 이 값에는 NULL 종결자에 대한 공간이 포함되지 않습니다.

반환 값

개체의 (NULL로 종료된) 문자 버퍼에 대한 LPWSTR 포인터입니다.

설명

반환된 LPWSTR 은 const 가 아니므로 CHString 콘텐츠를 직접 수정할 수 있습니다.

GetBuffer에서 반환된 포인터를 사용하여 문자열 내용을 변경하는 경우 다른 CHString 메서드를 사용하기 전에 ReleaseBuffer를 호출해야 합니다.

ReleaseBuffer를 호출한 후 추가 CHString 작업으로 인해 CHString 버퍼가 다시 할당될 수 있으므로 GetBuffer에서 반환된 주소가 유효하지 않을 수 있습니다. CHString 문자열의 길이를 변경하지 않으면 버퍼가 다시 할당되지 않습니다. CHString 개체가 제거되면 버퍼 메모리가 자동으로 해제됩니다.

문자열 길이를 직접 추적하는 경우 종결 NULL 문자를 추가하면 안 됩니다. 그러나 ReleaseBuffer를 사용하여 버퍼를 해제할 때 최종 문자열 길이를 지정해야 합니다. 종료 되는 NULL 문자를 추가하는 경우 길이에 대해 –1을 ReleaseBuffer에 전달해야 합니다. 이 경우 버퍼에서 wcslen 을 호출하여 길이를 결정합니다.

요구 사항

추가 정보

CHString

CHString::GetBufferSetLength

CHString::ReleaseBuffer