Share via

VectorFromBstr

  • Article

This function returns a vector assigning each character in the BSTR to an element of the vector.

HRESULT VectorFromBstr(
  BSTR bstr, 
  SAFEARRAY FAR* FAR* ppsa 
);

Parameters

  • bstr
    [in] Unicode string to be converted to a vector.
  • ppsa
    [out] On exit, pointer to a one-dimensional safearray that contains the characters in the BSTR.

Return Values

The following table shows the HRESULT values that can be returned by this function.

Value Description
S_OK Success.
E_OUTOFMEMORY Out of memory.
E_INVALIDARG BSTR is NULL.

Remarks

Passing invalid (and under some circumstances NULL) pointers to this function causes an unexpected termination of the application.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Oleauto.h.
Link Library: Oleaut32.lib.

See Also

BSTR

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.