Finalidade
Obtém o valor do atributo "namespace" para o elemento de sintaxe
especificado
Definido em |
Type |
Membro |
CPI_VFT |
Opcional |
iFpElementValue |
Sintaxe
CciSize cpiElementNamespace(
int* returnCode,
CciElement* targetElement,
const CciChar* value,
CciSize length);
Parâmetros
- returnCode
- Uma entrada de ponteiro NULL significa que o nó definido pelo usuário não irá lidar com erros. Quaisquer exceções lançadas durante a
execução desta chamada serão lançadas novamente para o próximo nó
acima no fluxo. Se a entrada não for NULL, a saída significará o
status de êxito da chamada. Se uma exceção ocorrer durante a
execução, *returnCode será definido como CCI_EXCEPTION na saída. Uma
chamada para CciGetLastExceptionData fornecerá detalhes da exceção.
Se o responsável pela chamada não alocou memória suficiente para
conter o valor de espaço de nomes, *returncode será definido como
CCI_BUFFER_TOO_SMALL.
Os possíveis
códigos de retorno são:
- CCI_SUCCESS
- CCI_EXCEPTION
- CCI_INV_ELEMENT_OBJECT
- CCI_INV_DATA_POINTER
- CCI_INV_DATA_BUFLEN
- CCI_INV_BUFFER_TOO_SMALL
- targetElement
- Especifica o endereço do objeto do elemento de sintaxe de
destino.
- value
- Especifica o endereço de um buffer para o qual o valor de
espaço de nomes do elemento será copiado. Uma cadeia de caracteres
(incluindo um terminador NULL) representando o valor de espaço de nomes é
copiada para esse buffer. O buffer deve ser uma parte da memória
alocada anteriormente pelo responsável pela chamada
- length
- O comprimento em CciChars do buffer especificado pelo parâmetro de valor.
Valores de Retorno
Se bem-sucedida, o número de CciChars copiados para o buffer é
retornado.
Se o buffer não for grande o suficiente para conter o valor de atributo, returnCode será configurado como CCI_BUFFER_TOO_SMALL
e o número de bytes CciChars requeridos será retornado.
Amostra
elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
elementNamespaceLength = cpiElementNamespace(&rc;,
element,
elementNamespace,
elementNamespaceLength);
if (rc==CCI_BUFFER_TOO_SMALL){
free(elementNamespace);
elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
elementNamespaceLength = cpiElementNamespace(&rc;,
element,
elementNamespace,
elementNamespaceLength);
}
checkRC(rc);