Método ICallFrame::Copy (callobj.h)

Crea una copia de este marco de llamada y todos sus datos asociados.

Advertencia El marco de llamada no limpia automáticamente los datos copiados. Por lo tanto, una vez que se devuelve la copia, el usuario es responsable de llamar a Free en la copia de fotogramas. Esto debe hacerse para evitar una pérdida de memoria.

 

Sintaxis

HRESULT Copy(
  [in]  CALLFRAME_COPY   copyControl,
  [in]  ICallFrameWalker *pWalker,
  [out] ICallFrame       **ppFrame
);

Parámetros

[in] copyControl

Determina si los datos de fotogramas de llamada copiados se pueden compartir con los datos del marco primario mediante la determinación de su dependencia de duración en el marco primario. Para obtener una lista de valores, consulte la enumeración CALLFRAME_COPY . Si se establece la marca de CALLFRAME_COPY_NESTED, el cliente será responsable de usar el marco de llamada copiado de forma que su duración esté anidada en la duración de su marco primario, lo que hace que los datos se puedan compartir. Si se establece el CALLFRAME_COPY_INDEPENDENT, la duración del marco copiado será independiente de los elementos primarios.

[in] pWalker

Puntero a una instancia de la interfaz ICallFrameWalker . Se llamará al método OnWalkInterface para cada puntero de interfaz que se copie. Si no se proporciona este parámetro, se pasará a AddRef cualquier puntero de interfaz que se copie.

[out] ppFrame

Puntero a un puntero ICallFrame a una copia del marco de llamada.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Copiar un marco es como unmarshalling de un marco serializado. El marco de llamada solo se puede copiar si tiene parámetros en. Si se invoca el marco de llamada, no se puede copiar. El método copy copia punteros de interfaz como valores binarios y no se realizan ajustes de recuento a los que se hace referencia. Pero si se desea este comportamiento, se puede usar un puntero a ICallFrameWalker .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	callobj.h

Consulte también

ICallFrame