IPStore::ReadItem 메서드

[보호된 스토리지(Pstore)는 Windows Server 2003 및 Windows XP에서 사용할 수 있습니다. Windows Server 2008 및 Windows Vista에서 읽기 전용 작업에만 사용할 수 있지만 후속 버전에서는 사용할 수 없습니다. Pstore는 데이터 보호의 이전 구현을 사용합니다. 개발자는 CryptProtectData 및 CryptUnprotectData 함수에서 제공하는 더 강력한 데이터 보호를 활용하는 것이 좋습니다.]

보호된 스토리지에서 지정된 데이터 항목을 읽습니다.

구문

HRESULT ReadItem(
  [in]       PST_KEY        Key,
  [in] const PSGUID         *pItemType,
  [in] const GUID           *pItemSubtype,
  [in]       LPCWSTR        *szItemName,
  [in]       DWORD          cbData,
  [in]       BYTE_RPC_FAR   *pbData,
  [in]       PPST_PROMPTIFO pPromptInfo,
  [in]       DWORD          dwFlags
);

매개 변수

키 [in]

공급자 스토리지 영역입니다.

값	의미
PST_KEY_CURRENT_USER 0x00000000	스토리지는 레지스트리의 현재 사용자 섹션에서 유지 관리됩니다.
PST_KEY_LOCAL_MACHINE 0x00000001	스토리지는 레지스트리의 로컬 컴퓨터 섹션에서 유지 관리됩니다.

 

pItemType [in]

읽을 항목의 데이터 형식을 식별하는 GUID에 대한 포인터입니다.

pItemSubtype [in]

읽을 항목의 데이터 하위 형식을 식별하는 GUID에 대한 포인터입니다.

szItemName [in]

저장된 데이터 항목에 할당된 이름을 포함하는 문자열에 대한 포인터입니다.

cbData [in]

저장된 데이터 항목이 포함된 버퍼의 크기를 나타내는 DWORD 입니다.

pbData [in]

저장된 데이터 항목을 포함하는 버퍼에 대한 포인터입니다.

pPromptInfo [in]

PST_PROMPTINFO 구조체에 대한 포인터입니다.

dwFlags [in]

읽기 작업에 대한 사용자 인터페이스 및 보안 동작을 지정합니다.

플래그 값은 논리적 OR과 결합할 수 있습니다.

값	의미
PST_UNRESTRICTED_ITEMDATA 0x00000004	데이터 스트림이 안전하지 않음을 지정합니다. 기본적으로 항목 호출은 안전합니다.
PST_PROMPT_QUERY 0x00000008	성공 시 확인이 반환되도록 지정합니다. 사용자 인터페이스를 사용하도록 설정하면 PST_E_OK 성공이 반환됩니다. 사용자 인터페이스를 사용하도록 설정하지 않으면 PST_E_ITEM_EXISTS 값이 반환됩니다.
PST_NO_UI_MIGRATION 0x00000010	사용자 지정 암호가 필요하지 않은 경우 사용자 인터페이스를 표시하지 마세요.

 

반환 값

반환 값은 HRESULT 값입니다. PST_E_OK 값은 함수가 성공했음을 나타냅니다.

설명

ReadItem이 성공적으로 완료되면 애플리케이션은 CoTaskMemFree 함수를 사용하여 반환된 데이터 버퍼를 해제해야 합니다.

요구 사항

추가 정보

IPStore

PST_PROMPTINFO