CCommand::em aberto

Artigo
08/25/2010

Executa e, opcionalmente, vincula o comando.

HRESULT Open(
   const CSession& session,
   LPCWSTR wszCommand,
   DBPROPSET *pPropSet = NULL,
   DBROWCOUNT* pRowsAffected = NULL,
   REFGUID guidCommand = DBGUID_DEFAULT,
   bool bBind = true,
   ULONG ulPropSets = 0
) throw( );
HRESULT Open(
   const CSession& session,
   LPCSTR szCommand,
   DBPROPSET *pPropSet = NULL,
   DBROWCOUNT* pRowsAffected = NULL,
   REFGUID guidCommand = DBGUID_DEFAULT,
   bool bBind = true,
   ULONG ulPropSets = 0
) throw( );
HRESULT Open(
   const CSession& session,
   INT szCommand = NULL,
   DBPROPSET *pPropSet = NULL,
   DBROWCOUNT* pRowsAffected = NULL,
   REFGUID guidCommand = DBGUID_DEFAULT,
   bool bBind = true,
   ULONG ulPropSets = 0
) throw( );
HRESULT Open(
   DBPROPSET *pPropSet = NULL,
   DBROWCOUNT* pRowsAffected = NULL,
   bool bBind = true,
   ULONG ulPropSets = 0
) throw( );

Parâmetros

session
[in] A sessão na qual deseja executar o comando.
wszCommand
[in] O comando a ser executado, é passado sistema autônomo uma seqüência de caracteres Unicode.Pode ser NULO quandoCAccessor, caso em que o comando será recuperado do valor passado para o DEFINE_COMMAND macro.See ICommand::executar in the Referência do programador do OLE DB para obter detalhes.
szCommand
[in] Igual a wszCommand exceto pelo fato de que esse parâmetro usa uma seqüência de caracteres de comando ANSI. Quarta forma desse método pode ter um valor nulo.Consulte "Comentários", posteriormente neste tópico para obter detalhes.
pPropSet
[in] Um ponteiro para uma matriz de DBPROPSET estruturas que contém propriedades e os valores a ser definido.See Propriedade conjuntos e grupos de propriedades in the Referência do programador do OLE DB in the Windows SDK.

pRowsAffected
[in/out] Um ponteiro para memória onde a contagem de linhas afetadas por um comando é retornada.If * pRowsAffected is NULO, será retornada sem contagem de linhas.Caso contrário, em aberto sets *pRowsAffected de acordo com às seguintes condições:

Se	Então
The cParamSets elemento pParams é maior que 1	*pRowsAffected representa o número total de linhas afetadas por todos os conjuntos de parâmetro especificados em execução.
O número de linhas afetadas não está disponível	*pRowsAffected é definido como -1.
O comando não atualizar, excluir ou inserir linhas	*pRowsAffected não está definida.

guidCommand
[in] Um GUID que especifica a sintaxe e regras Geral para o provedor a ser usado na análise do texto de comando.See ICommandText::GetCommandText and ICommandText::SetCommandText in the Referência do programador do OLE DB para obter detalhes.
bBind
[in] Especifica se você deseja BIND o comando automaticamente depois que está sendo executado.O padrão é True, que faz com que o comando deve ser vinculada automaticamente.Definir bBind para False impede que a vinculação automático do comando para que você pode BIND manualmente.(A vinculação manual é especialmente interessante para os usuários OLAP.)
ulPropSets
[in] O número de DBPROPSET estruturas passado o pPropSet argumento.

Valor de retorno

Um padrão HRESULT.

Comentários

sistema autônomo três primeiras formas de em aberto tenham uma sessão, criar um comando e executar o comando, todos sistema autônomo parâmetros de ligação conforme necessário.

A primeira formulário de em aberto leva uma seqüência de caracteres de comando Unicode e não tem valor padrão.

O segundo formulário de em aberto leva uma seqüência de caracteres de comando ANSI e nenhum valor padrão (fornecido por questões de compatibilidade com aplicativos existentes do ANSI).

A terceira formulário de em aberto permite que a seqüência de comandos como nulo, por causa do tipo int com um valor padrão nulo. Ele é fornecido para chamar Open(session, NULL); ou Open(session); porque é nulo de tipo int. Esta versão requer e declara que o int parâmetro ser nulo.

Use a forma quarta de em aberto quando já tiver criado um comando e você desejar executar um único Preparar e várias execuções.

Observação:
em aberto calls Executar, que por sua vez chama a GetNextResult.

Requisitos

Cabeçalho: atldbcli.h

Consulte também

Referência

Classe CCommand

Outros recursos

CCommand membros

Compartilhar via