Método IPhotoAcquireSettings::SetOutputFilenameTemplate (photoacquire.h)

El SetOutputFilenameTemplate método especifica una cadena de formato (plantilla) que especifica el formato de los nombres de archivo.

Sintaxis

HRESULT SetOutputFilenameTemplate(
  [in] LPCWSTR pszTemplate
);

Parámetros

[in] pszTemplate

Puntero a una cadena terminada en null que contiene la cadena de formato.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.

Comentarios

Las cadenas de formato contienen una combinación de literales y tokens de ruta de acceso. Una cadena de formato es similar a la siguiente:

$(MyPicturesFolder)\$(DateAcquired), $(EventName)\$(EventName) $(SequenceNumber).$(OriginalExtension)

El formato de token es similar al siguiente, donde OptionalPrefix y OptionSuffix se suprimen si el reemplazo de TokenIdentifier produce una cadena de longitud cero:

$([OptionalPrefix]TokenIdentifier:SubToken[OptionalSuffix]|AlternateString)

El símbolo de intercalación ("^") es un carácter de escape, por lo que "^$" produciría "$" en la ruta final.

Los paréntesis y corchetes no se permiten como literales dentro de los tokens, pero se pueden usar fuera de los tokens. Esto significa que no puede usar "[", "]", "(" o ")" dentro del OptionalString sub token a menos que se escapen con un símbolo de intercalación ("^").

Hay algunas clases de tokens diferentes, entre las que se incluyen las siguientes:

Variables SHGetSpecialFolder como las siguientes. Estos deben ser el primer token y solo pueden producirse una vez, como máximo:

• MyPicturesFolder
• MyDocumentsFolder

Variables de sesión como las siguientes:

• SequenceNumber (El número de secuencia se usa para evitar colisiones de nombre de archivo; si existe, debe estar en la parte del nombre de archivo de la ruta de acceso).
• DateAcquired
• EventName
• UserName
• MachineName

Variables de archivo y metadatos, como las siguientes:

• DateTaken
• OriginalFilename
• OriginalExtension
• CameraModel
• Width
• Height

Dado que estos tokens no están diseñados para ser visibles para los usuarios, no se localizarán. Por ejemplo, $(DateTaken) será el mismo en todas las versiones de Microsoft Windows, independientemente de la configuración regional o de idioma.

Por ejemplo, supongamos que EventName es "Cumpleaños de Meghan" y el patrón de nomenclatura es el siguiente:

$(MyPicturesFolder)\$(DateAcquired)$([, ]EventName)\$(EventName[ ])$(SequenceNumber).$(OriginalExtension)

Los archivos resultantes se denominarían como se indica a continuación:

C:\Documents and Settings\shauniv\My Documents\My Pictures\2003-11-14, Meghan's Birthday\Meghan's Birthday 001.jpg

C:\Documents and Settings\shauniv\My Documents\My Pictures\2003-11-14, Meghan's Birthday\Meghan's Birthday 002.jpg

C:\Documents and Settings\shauniv\My Documents\My Pictures\2003-11-14, Meghan's Birthday\Meghan's Birthday 003.jpg

C:\Documents and Settings\shauniv\My Documents\My Pictures\2003-11-14, Meghan's Birthday\Meghan's Birthday 004.jpg

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	photoacquire.h
Library	PhotoAcquireUID.lib

Consulte también

GetOutputFilenameTemplate

IPhotoAcquireSettings (Interfaz)