Share via


CSimpleStringT::LockBuffer

참조 횟수를 사용 하지 않도록 설정 하 고 문자열 버퍼에서를 보호 합니다.

PXSTR LockBuffer( );

반환 값

에 대 한 포인터는 CSimpleStringT 개체 또는 null로 끝나는 문자열입니다.

설명

버퍼를 잠그려면이 메서드를 호출 하 여 CSimpleStringT 개체입니다.호출 하 여 LockBuffer, 참조 수를 – 1로 문자열의 복사본을 만듭니다.참조 횟수 값이-1 이면 문자열 버퍼에 "잠금된" 상태에 있을 것입니다.잠긴 상태 동안 문자열 두 가지 방법으로 보호 됩니다.

  • 잠긴된 문자열에 문자열을 할당 하는 경우에 다른 문자열이 잠긴된 문자열에 대 한 참조 데이터를 얻을 수 있습니다.

  • 절대로 잠긴된 문자열 잠긴된 문자열에 다른 문자열을 복사 하는 경우에 다른 문자열을 참조 합니다.

문자열 버퍼를 잠그면 단독 버퍼 대기는 문자열 그대로 유지 해야 합니다.

마친 후 LockBuffer을 호출 UnlockBuffer 참조 횟수를 1로 다시 설정 합니다.

[!참고]

호출 하는 경우 GetBuffer 잠긴된 버퍼 및 사용자 설정 된 GetBuffer 매개 변수 nMinBufferLength 현재 버퍼의 길이 보다 더 큰 수, 버퍼 잠금을 손실 됩니다.이러한 호출에 GetBuffer 현재 버퍼 삭제 요청 된 크기의 버퍼를 바꾸고 참조 횟수가 0으로 재설정 합니다.

참조 횟수에 대 한 자세한 내용은 다음 문서를 참조 하십시오.

예제

다음 예제는 CSimpleStringT::LockBuffer의 사용을 보여 줍니다.

CSimpleString str(_T("Hello"), pMgr);
TCHAR ch;

str.LockBuffer();
ch = str.GetAt(2);
_tprintf_s(_T("%c"), ch);
str.UnlockBuffer();

요구 사항

헤더: atlsimpstr.h

참고 항목

참조

CSimpleStringT 클래스

CSimpleStringT::ReleaseBuffer