Método IXpsSignatureBlockCollection::RemoveAt (xpsdigitalsignature.h)
Quita y libera un puntero de interfaz IXpsSignatureBlock de una ubicación especificada en la colección.
Sintaxis
HRESULT RemoveAt(
UINT32 index
);
Parámetros
index
Índice de base cero de la colección desde la que se va a quitar y liberar un puntero de interfaz IXpsSignatureBlock .
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error HRESULT .
Comentarios
Desde la ubicación especificada por el índice, este método libera la interfaz a la que hace referencia un puntero IXpsSignatureBlock . A continuación, el método compacta la colección reduciendo en 1 el índice de cada puntero posterior al índice. Para obtener más información sobre los métodos de recopilación, vea Working with XPS OM Collection Interfaces.
Al quitar un bloque de firma de la colección, se quita del paquete el elemento SignatureDefinitions y la relación que corresponden a ese bloque de firma. Esta eliminación interrumpe las firmas existentes. Además, el nombre del elemento SignatureDefinitions se quita de la lista de elementos XPS necesarios, lo que impide que las nuevas firmas incluyan el bloque de firma quitado.
Una interfaz que se ha quitado de una colección ya no es válida. Si una aplicación conserva un puntero a la interfaz e intenta llamar a uno de sus métodos, el método devolverá XPS_E_OBJECT_DETACHED.
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | xpsdigitalsignature.h |