GetStringsFromBlob 함수
GetStringsFromBlob 함수는 순차 호출을 사용하여 지정된 범위 내의 모든 문자열을 검색합니다.
구문
DWORD GetStringsFromBlob(
_In_ HBLOB hBlob,
_In_ const char *pRequestedOwnerName,
_In_ const char *pRequestedCategoryName,
_In_ const char *pRequestedTagName,
_Out_ const char **ppReturnedOwnerName,
_Out_ const char **ppReturnedCategoryName,
_Out_ const char **ppReturnedTagName,
_Out_ const char **ppReturnedString,
_Out_ DWORD *pRestartKey
);
매개 변수
-
hBlob [in]
-
BLOB에 대한 핸들입니다.
-
pRequestedOwnerName [in]
-
문자열을 가져올 소유자 섹션에 대한 포인터입니다.
-
pRequestedCategoryName [in]
-
문자열을 가져올 범주 섹션에 대한 포인터입니다.
-
pRequestedTagName [in]
-
요청된 문자열의 태그에 대한 포인터입니다.
-
ppReturnedOwnerName [out]
-
소유자 이름이 반환되는 위치를 가리키는 변수에 대한 포인터입니다.
-
ppReturnedCategoryName [out]
-
범주 이름이 반환되는 위치를 가리키는 변수에 대한 포인터입니다.
-
ppReturnedTagName [out]
-
태그 이름이 반환되는 위치를 가리키는 변수에 대한 포인터입니다.
-
ppReturnedString [out]
-
문자열 이름이 반환되는 위치를 가리키는 변수에 대한 포인터입니다.
-
pRestartKey [out]
-
다시 시작 키를 지정하고 반환할 변수에 대한 포인터입니다.
반환 값
함수가 성공하면 반환 값이 NMERR_SUCCESS.
함수가 실패하면 반환 값은 문제를 나타내는 NMERR 값입니다.
소유자, 범주 및 태그 정보의 지정된 조합이 없는 경우 반환 값은 NMERR_BLOB_ENTRY_DOES_NOT_EXIST.
BLOB이 처음 지정된 범위 내에서 완전히 트래버스되면 함수는 NMERR_BLOB_ENTRY_DOES_NOT_EXIST 반환하고 pRestartKey 매개 변수는 0을 가리킵니다.
설명
GetStringsFromBlob 함수에 대한 초기 호출에서 pRestartKey 매개 변수는 값이 0인 변수를 가리킵니다. pRequested 매개 변수는 다시 시작 키가 0인 경우에만 사용할 수 있습니다. 후속 호출에서 pRestartKey 에 0이 아닌 값이 있는 경우 pRequested 매개 변수는 무시됩니다. 초기 호출에서 모두 NULL을 가리킬 수 있습니다. 이 NULL은 BLOB의 모든 항목을 반환하도록 쿼리를 설정하며, 이후 호출당 하나씩 반환됩니다.
소유자를 지정하면 해당 소유자에게만 반환되는 문자열이 제한됩니다. 범주 및 태그에 대해서도 비슷한 제한 사항이 적용되며, 범주를 지정하는 경우 소유자도 지정해야 하며 태그가 지정되면 범주(따라서 소유자)를 지정해야 한다는 추가 주의 사항이 있습니다.
GetStringsFromBlob에 대한 초기 호출이 반환되면 pRestartKey는 다음 값을 가져오기 위해 함수에 대한 다음 호출에서 지정해야 하는 새 값을 가리킵니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|