AllocCountedString 함수
참고
네트워크 액세스 보호 플랫폼은 Windows 10
AllocCountedString 함수는 null로 종료된 문자열에 대한 메모리를 할당하고 CountedString 구조로 반환합니다.
구문
NAPAPI HRESULT WINAPI AllocCountedString(
_Inout_ CountedString **countedString,
_In_ const WCHAR *string
);
매개 변수
-
countedString [in, out]
-
새로 할당된 CountedString 구조체의 주소에 대한 포인터입니다.
-
string [in]
-
countedString에서 반환될 null로 끝나는 문자열에 대한 포인터입니다.
반환 값
| 반환 코드 | Description |
|---|---|
|
작업이 성공적으로 완료되었습니다. |
|
잘못된 인수가 전달된 경우 |
|
시스템이 가상 메모리가 부족합니다. 이 작업이 실패했습니다. |
설명
NAP 시스템에서 지원하는 모든 COM 인터페이스는 표준 COM 메모리 관리 규칙 및 COM 메모리 할당자(CoTaskMemAlloc 및 CoTaskMemFree)를 사용합니다.
- 매개 변수에서 호출자가 할당하고 해제합니다.
- Out 매개 변수는 호출 수신자가 할당하고 CoTaskMem을 사용하여 호출자가 해제합니다.
- In/out 매개 변수는 호출자가 할당하고, 호출자가 해제 및 재할당하고, 궁극적으로 CoTaskMem을 사용하여 호출자가 해제합니다.
메모리를 해제하기 위한 모든 NAP 함수도 포함된 모든 포인터를 해제합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |
| 헤더 |
|
| DLL |
|