Compartilhar via


Método ISCardTypeConv::CreateSafeArray

[O método CreateSafeArray está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele não está disponível para uso no Windows Server 2003 com Service Pack 1 (SP1) e posterior, Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. Os Módulos de Cartão Inteligente fornecem funcionalidade semelhante.]

O método CreateSafeArray cria um SAFEARRAY de Automação de caracteres não assinados (bytes).

Sintaxe

HRESULT CreateSafeArray(
  [in]  UINT        nAllocSize,
  [out] LPSAFEARRAY *ppArray
);

Parâmetros

nAllocSize [in]

Tamanho em bytes da memória a ser alocada para a matriz.

ppArray [out]

Ponteiro para o objeto SAFEARRAY a ser retornado.

Valor retornado

O método retorna um dos seguintes valores possíveis:

Código de retorno Descrição
S_OK
Memória alocada com êxito.
E_INVALIDARG
Há algo errado com um ou mais dos parâmetros passados para a função.
E_OUTOFMEMORY
Não há memória livre suficiente para atender à solicitação.

 

Comentários

Para criar uma matriz de bytes C/C++ típica, chame CreateByteArray.

Para criar um buffer universal de bytes mapeados em um objeto IStream (IByteBuffer), chame CreateByteBuffer.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Fim do suporte ao cliente
Windows XP
Fim do suporte ao servidor
Windows Server 2003
Cabeçalho
Scarddat.h
Biblioteca de tipos
Scarddat.tlb
DLL
Scardssp.dll
IID
IID_ISCardTypeConv é definido como 53B6AA63-3F56-11D0-916B-00AA00C18068

Confira também

ISCardTypeConv

Valores retornados do cartão inteligente

CreateByteArray

CreateByteBuffer