ISpecifyPropertyPages::GetPages 메서드(ocidl.h)
이 개체의 속성 시트에 표시할 수 있는 속성 페이지의 목록을 검색합니다.
구문
HRESULT GetPages(
[out] CAUUID *pPages
);
매개 변수
[out] pPages
함수가 반환되기 전에 초기화하고 채우는 호출자가 할당한 CAUUID 구조체에 대한 포인터입니다. 구조체의 pElems 멤버는 CoTaskMemAlloc을 사용하여 함수에 의해 할당되며 , 호출자가 CoTaskMemFree를 사용하여 해제해야 합니다.
반환 값
이 메서드는 다음 값뿐만 아니라 E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값을 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 완료되었습니다. |
|
pPages의 주소가 잘못되었습니다. 예를 들어 NULL일 수 있습니다. |
설명
CAUUID 구조체는 호출자가 할당하지만 호출자에 의해 초기화되지 않습니다. GetPages 메서드는 구조체의 cElements 멤버를 채웁니다. 또한 이 메서드는 CoTaskMemAlloc을 사용하여 pElems 멤버가 가리키는 배열에 대한 메모리를 할당합니다. 그런 다음 새로 할당된 배열을 채웁니다. 이 메서드가 성공적으로 반환되면 구조체에는 속성 페이지 CLSID를 지정하는 각 UUID의 계산된 UUID 배열이 포함됩니다.
발신자에게 참고 사항
호출자는 더 이상 필요하지 않은 경우 CoTaskMemFree를 사용하여 CAUUID의 pElems 멤버가 가리키는 메모리를 해제해야 합니다.구현자에 대한 참고 사항
속성 페이지가 없는 개체는 ISpecifyPropertyPages 인터페이스를 노출해서는 안 되므로 E_NOTIMPL 반환 값으로 사용할 수 없습니다.요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | ocidl.h |