.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH SafeArrayAllocDescriptorEx 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBSafeArrayAllocDescriptorEx\fR (OLEAUT32.41)
.SH SYNOPSIS
HRESULT SafeArrayAllocDescriptorEx
 (
  VARTYPE     \fIvt\fR,
  UINT        \fIcDims\fR,
  SAFEARRAY** \fIppsaOut\fR
 )

.SH DESCRIPTION
.PP
Allocate and initialise a descriptor for a SafeArray of a given type. 

.SH PARAMS
\fIvt\fR \fB[In]\fR  The type of items to store in the array.
.PP
\fIcDims\fR \fB[In]\fR  Number of dimensions of the array.
.PP
\fIppsaOut\fR \fB[Out]\fR  Destination for new descriptor.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR \fBS_OK\fR. \fIppsaOut\fR is filled with a newly allocated descriptor. 
.PP
\fBFailure:\fR An \fBHRESULT\fR error code indicating the error. 

.SH NOTES
.PP
\fB-\fR This function does not check that \fIvt\fR is an allowed \fBVARTYPE\fR. 
.PP
\fB-\fR Unlike \fBSafeArrayAllocDescriptor(3w)\fR, \fIvt\fR is associated with the array. See \fBSafeArray(3w)\fR. 

.SH IMPLEMENTATION
.PP
Declared in \fB"oleauto.h"\fR. 
.PP
Implemented in \fB"dlls/oleaut32/safearray.c"\fR. 
.PP
Debug channel \fB"variant"\fR.