Método IByteBuffer::Initialize

[O método Initialize 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. A interface IStream fornece funcionalidade semelhante.]

O método Initialize prepara o objeto IByteBuffer para uso. Esse método deve ser chamado antes de chamar outros métodos na interface IByteBuffer .

Sintaxe

HRESULT Initialize(
  [in] LONG lSize,
  [in] BYTE *pData
);

Parâmetros

lSize [in]

Tamanho inicial, em bytes, dos dados que o fluxo deve conter.

pData [in]

Se não for NULL, os dados iniciais a serem gravados no fluxo.

Valor retornado

O valor retornado é um HRESULT. Um valor de S_OK indica que a chamada foi bem-sucedida.

Comentários

Ao usar um novo fluxo IByteBuffer , chame esse método antes de usar qualquer um dos outros métodos IByteBuffer .

Exemplos

O exemplo a seguir mostra a inicialização do objeto IByteBuffer .

UCHAR    ucFileName[] = {0x3f, 0x00};    // Master File (MF)
HRESULT  hr;

// pIByteRequest is a pointer to an instantiated IByteBuffer object.
hr = pIByteRequest->Initialize(2, ucFileName);
if (FAILED(hr))
    printf("Failed IByteBuffer::Initialize\n");

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	Scardssp.h
Biblioteca de tipos	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer é definido como E126F8FE-A7AF-11D0-B88A-00C04FD424B9