IVsSettingsStore.GetBinary(String, String, UInt32, Byte[], UInt32[]) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回所请求的属性的值,该属性的数据类型为 SettingsType_Binary。
int GetBinary(std::wstring const & collectionPath, std::wstring const & propertyName, unsigned int byteLength, std::Array <byte> const & pBytes, std::Array <unsigned int> const & actualByteLength);
public int GetBinary (string collectionPath, string propertyName, uint byteLength, byte[] pBytes, uint[] actualByteLength);
abstract member GetBinary : string * string * uint32 * byte[] * uint32[] -> int
Public Function GetBinary (collectionPath As String, propertyName As String, byteLength As UInteger, Optional pBytes As Byte(), Optional actualByteLength As UInteger()) As Integer
参数
- collectionPath
- String
中集合的路径。
- propertyName
- String
中属性名称。
- byteLength
- UInt32
中的大小(以字节为单位) pBytes 。 如果调用方想要了解值的大小而不复制该值,则可以为0。
- pBytes
- Byte[]
弄要用属性填充的缓冲区。 如果调用方想要知道缓冲区的大小而不进行复制,则可以为 null。
- actualByteLength
- UInt32[]
弄返回的实际字节数。
返回
如果 S_OK 返回属性,则返回; 如果属性不存在,则返回; S_FALSE E_INVALIDARG 如果属性类型不是二进制,则返回。
注解
若要查找属性的大小,请在参数中传递 0 byteLength 。 将在中返回属性的实际长度(以字节为单位) actualByteLength ,但不会将任何数据复制到 pBytes 。