Edit

Share via

LPSAFEARRAY_UserUnmarshal function (wia_xp.h)

  • Article

Unmarshals a SAFEARRAY object from the RPC buffer.

Syntax

unsigned char * LPSAFEARRAY_UserUnmarshal(
  [in]      unsigned long *unnamedParam1,
  [in, out] unsigned char *unnamedParam2,
  [in]      LPSAFEARRAY   *unnamedParam3
);

Parameters

[in] unnamedParam1

The data used by RPC.

[in, out] unnamedParam2

The current buffer. This pointer may or may not be aligned on entry. The function aligns the buffer pointer, marshals the data, and returns the new buffer position, which is the address of the first byte after the marshaled object.

[in] unnamedParam3

Receives the safe array that contains the data.

Return value

The value obtained from the returned HRESULT value is one of the following.

Return code Description
S_OK
Success.
RPC_X_BAD_STUB_DATA
The stub has received bad data.
E_UNEXPECTED
The array could not be found.
E_OUTOFMEMORY
Insufficient memory for this function to perform.
DISP_E_BADCALLEE
The SAFEARRAY object does not have the correct dimensions, does not have the correct features, or memory cannot be reallocated.

Requirements

Requirement Value
Target Platform Windows
Header wia_xp.h (include Propidlbase.h)
Library OleAut32.lib
DLL OleAut32.dll