Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The GetBufferValue method retrieves a byte array value (type VT_VECTOR | VT_UI1) specified by a key.
Syntax
HRESULT GetBufferValue(
[in] REFPROPERTYKEY key,
[out] BYTE **ppValue,
[out] DWORD *pcbValue
);
Parameters
-
key [in]
-
A REFPROPERTYKEY key that specifies the item to retrieve.
-
ppValue [out]
-
Pointer to the retrieved BYTE* value. The caller is responsible for freeing the memory by calling CoTaskMemFree.
-
pcbValue [out]
-
Pointer to the size of ppValue, in bytes.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
The property specified by key is not a BYTE* type. |
|
The property specified by key is not in the collection. |
Remarks
Retrieving a NULL buffer or a zero-sized buffer is not supported.
Requirements
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|