IStorage::OpenStream 메서드(objidl.h)
OpenStream 메서드는 지정된 액세스 모드에서 이 스토리지 개체 내의 기존 스트림 개체를 엽니다.
구문
HRESULT OpenStream(
[in] const OLECHAR *pwcsName,
[in] void *reserved1,
[in] DWORD grfMode,
[in] DWORD reserved2,
[out] IStream **ppstm
);
매개 변수
[in] pwcsName
열 스트림의 이름을 포함하는 와이드 문자 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 스트림/스토리지 이름의 첫 번째 문자 역할을 하는 000~01f 문자는 OLE에서 사용하도록 예약되어 있습니다. 이는 구조적 스토리지 제한이 아니라 복합 파일 제한입니다.
[in] reserved1
나중에 사용하도록 예약됨; 은 NULL이어야 합니다.
[in] grfMode
열린 스트림에 할당할 액세스 모드를 지정합니다. 가능한 값에 대한 자세한 내용과 설명은 STGM 상수를 참조하세요. 선택한 다른 모드는 복합 파일 구현에서 이 메서드를 호출할 때 적어도 STGM_SHARE_EXCLUSIVE 지정해야 합니다.
[in] reserved2
나중에 사용하도록 예약되어 있습니다. 0이어야 합니다.
[out] ppstm
새로 연 스트림 개체에 대한 인터페이스 포인터를 수신하는 IStream 포인터 변수에 대한 포인터입니다. 오류가 발생하면 *ppstm 을 NULL로 설정해야 합니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
반환 코드 | 설명 |
---|---|
S_OK | 스트림이 성공적으로 열렸습니다. |
E_PENDING | 비동기 스토리지만 해당: 스트림 데이터의 일부 또는 전체를 현재 사용할 수 없습니다. |
STG_E_ACCESSDENIED | 스트림을 열 수 있는 권한이 부족합니다. |
STG_E_FILENOTFOUND | 지정된 이름의 스트림이 없습니다. |
STG_E_INSUFFICIENTMEMORY | 메모리 부족으로 인해 스트림이 열리지 않았습니다. |
STG_E_INVALIDFLAG | grfMode 매개 변수에 지정된 값이 유효한 STGM 상수 값이 아닙니다. |
STG_E_INVALIDFUNCTION | grfMode 매개 변수의 지정된 플래그 조합은 지원되지 않습니다. 예를 들어 이 메서드가 STGM_SHARE_EXCLUSIVE 플래그 없이 호출되는 경우입니다. |
STG_E_INVALIDNAME | pwcsName 값이 잘못되었습니다. |
STG_E_INVALIDPOINTER | 스트림 개체에 대해 지정된 포인터가 잘못되었습니다. |
STG_E_INVALIDPARAMETER | 매개 변수 중 하나가 잘못되었습니다. |
STG_E_REVERTED | 스토리지 개체가 트랜잭션 트리에서 위의 되돌리기 작업에 의해 무효화되었습니다. |
STG_E_TOOMANYOPENFILES | 열려 있는 파일이 너무 많기 때문에 스트림이 열리지 않았습니다. |
설명
IStorage::OpenStream 은 grfMode에 지정된 액세스 모드에서 이 스토리지 개체 내의 기존 스트림 개체를 엽니다. grfMode에 부여할 수 있는 권한에 대한 제한이 있습니다. 예를 들어 이 스토리지 개체에 대한 권한은 해당 스트림에 대한 권한을 제한합니다. 일반적으로 스트림에 대한 액세스 제한은 부모 스토리지의 액세스 제한보다 엄격해야 합니다. 복합 파일 스트림은 STGM_SHARE_EXCLUSIVE 사용하여 열어야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | objidl.h |
라이브러리 | Uuid.lib |
DLL | Ole32.dll |