Método IBackgroundCopyFile::GetLocalName (bits.h)
Recupera el nombre local del archivo.
Sintaxis
HRESULT GetLocalName(
[out] LPWSTR *pVal
);
Parámetros
[out] pVal
Cadena terminada en NULL que contiene el nombre del archivo en el cliente. El nombre está completo. Llame a la función CoTaskMemFree para liberar ppName cuando haya terminado.
Valor devuelto
Este método devuelve S_OK si se ejecuta correctamente o uno de los valores COM HRESULT estándar en caso de error.
Comentarios
El nombre de archivo local se establece al llamar a los métodos AddFile o AddFileSet de la interfaz IBackgroundCopyJob .
Ejemplos
En el ejemplo siguiente se muestra cómo recuperar los nombres de archivo locales y remotos y la información relacionada con el progreso de .
Interfaz IBackgroundCopyFile . En el ejemplo se supone que el puntero de interfaz IBackgroundCopyFile es válido.
IBackgroundCopyFile* pFile;
HRESULT hr;
WCHAR* pszLocalFileName = NULL;
WCHAR* pszRemoteFileName = NULL;
WCHAR szPercentComplete[4+1];
BG_FILE_PROGRESS Progress;
hr = pFile->GetLocalName(&pszLocalFileName);
if (SUCCEEDED(hr))
{
hr = pFile->GetRemoteName(&pszRemoteFileName);
if (SUCCEEDED(hr))
{
pFile->GetProgress(&Progress);
if (BG_SIZE_UNKNOWN == Progress.BytesTotal)
{
StringCchPrintf(szPercentComplete, sizeof(szPercentComplete), L"0%%");
}
else
{
StringCchPrintf(szPercentComplete, sizeof(szPercentComplete), L"%I64d%%",
100*Progress.BytesTransferred/Progress.BytesTotal);
}
//Do something with the file names and progress information.
}
}
if (pszLocalFileName)
CoTaskMemFree(pszLocalFileName);
if (pszRemoteFileName)
CoTaskMemFree(pszRemoteFileName);
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP |
| Servidor mínimo compatible | Windows Server 2003 |
| Plataforma de destino | Windows |
| Encabezado | bits.h |
| Library | Bits.lib |
| Archivo DLL | QmgrPrxy.dll |